home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / udos / runwen16 / runwen.doc < prev    next >
Text File  |  1992-08-29  |  8KB  |  171 lines
  1.      **********************************************************************
  2.      *                                                                    *
  3.      *                       RunWen Users Manual                          *
  4.      *                                                                    *
  5.      *              RunWen - A Boot-up Program Scheduler                  *
  6.      *                                                                    *
  7.      *               Copyright (c) 1992 Richard Hiester                   *
  8.      *                       All Rights Reserved                          *
  9.      *                                                                    *
  10.      **********************************************************************
  11.  
  12.      INTRODUCTION
  13.      ============
  14.  
  15.      RunWen is a DOS Program Scheduler which is normally started from your 
  16.      AUTOEXEC.BAT file.  This means that the programs you specify will be
  17.      started by RunWen when you boot-up your computer.  RunWen can age
  18.      the specified programs to run everytime you boot your computer, once 
  19.      a day, or once every N days.  Options are available to specify how
  20.      you want RunWen to run (in prompt or noprompt mode), to list the 
  21.      RunWen source file (RUNWEN.FIL), to display the RunWen Version number,
  22.      and to display a two-page help screen.
  23.  
  24.      With the use of the RUNWEN environment variable, RunWen is an excellent
  25.      program for use by LAN Administrators.  The RunWen program will read
  26.      the RUNWEN.FIL which resides in the subdirectory specified in the 
  27.      RUNWEN environment variable. By placing the command "RUNWEN -BOOT -NOP" 
  28.      in the autoexec.bat file of each node on the network, the LAN
  29.      LAN Administrator can ensure that the appropriate programs (i.e.
  30.      AnviVirus, Disk Scan, etc.) are run on each node on a scheduled basis.  
  31.      The RUNWEN environment variable can be set to the location of the 
  32.      RUNWEN.FIL source file, which can be placed on a read-only file system 
  33.      so it can not be altered by the user community.  
  34.  
  35.      INSTALLATION
  36.      ============
  37.  
  38.      The following files are part of this release of RunWen:
  39.  
  40.           RUNWEN.EXE   - The RunWen executable.
  41.           RUNWEN.FIL   - The RunWen source file.
  42.           RUNWEN.DOC   - This documentation file.
  43.           ORDERFRM.DOC - The order form used to register RunWen.
  44.           HISTORY.DOC  - A version history of RunWen.
  45.  
  46.      The installation of RunWen is easy:
  47.  
  48.      1)  Copy the above files into your desired directory.
  49.  
  50.      2)  Edit the RUNWEN.FIL source file to specify which DOS programs 
  51.          you want aged.
  52.  
  53.      3)  Edit your AUTOEXEC.BAT file adding the following lines:
  54.  
  55.               set RUNWEN=DRIVE:\DIRECTORY_TO_RUNWEN.FIL
  56.  
  57.               [DRIVE:PATH]RUNWEN -BOOT [-NOPROMPT]
  58.  
  59.      4)  Reboot your computer to start using RunWen.
  60.  
  61.                                                                    Page 2
  62.  
  63.      CONFIGURATION
  64.      =============
  65.  
  66.      The only configuration necessary for using RunWen is to add your
  67.      desired programs to the RUNWEN.FIL source file.  The RUNWEN.FIL
  68.      file contains one line for each program you want aged.  For you
  69.      UNIX types, the RUNWEN.FIL format is simular to the crontab.  The
  70.      RUNWEN.FIL format is as follows:
  71.  
  72.      YYYYMMDD DYS DOS_COMMAND_LINE
  73.  
  74.      where YYYYMMDD is the four-digit year, two-digit month, and two
  75.      digit day that you want RunWen to start aging the program from,
  76.      DYS is the number of days you want between executions of the program,
  77.      and DOS_COMMAND_LINE is the DOS command line you would enter to start
  78.      the program.  For instance, one of the programs I use RunWen for
  79.      is to run the Norton AntiVirus program.  I have the following entry in
  80.      my RUNWEN.FIL to run the Norton AntiVirus (full scan, all disks)
  81.      every seven days:
  82.  
  83.      19920801 7 C:\NDW\NAV.EXE /A
  84.  
  85.      By placing the above line in the RUNWEN.FIL file, Norton AntiVirus 
  86.      will be run the first time you boot your computer on (or after) 
  87.      August 8, 1992.  When the program is run, the RUNWEN.FIL is updated
  88.      to the NEW last date the program was run.  That is, if the AntiVirus
  89.      program is run on August 8, 1992, the the new entry in the RUNWEN.FIL
  90.      file will be:
  91.  
  92.      19920808 7 C:\NDW\NAV.EXE /A
  93.  
  94.      and the AntiVirus program will not be run by RunWen again until 
  95.      August 15, 1992.  
  96.  
  97.      Please read the comment lines in the RUNWEN.FIL file for further
  98.      information about the RUNWEN.FIL file.
  99.  
  100.      OPTIONS
  101.      =======
  102.  
  103.      The command line for RunWen is as follows:
  104.  
  105.      C> RUNWEN [-BOOT [-NOPROMPT]] | [-LIST] | [-VER] | [-HELP]
  106.  
  107.      The options available on the RunWen command-line are as follows:
  108.  
  109.      -BOOT (abbreviated to -B) is used to tell RunWen to process the 
  110.           RUNWEN.FIL file.
  111.  
  112.      -NOPROMPT (abbreviated to -NOP) is used in conjunction with -BOOT
  113.           to tell RunWen not to prompt you whether you want to run 
  114.           the program which is due to be run by RunWen.
  115.  
  116.      -LIST (abbreviated to -L) is used to list the RUNWEN.FIL on the 
  117.           screen.  This option cannot be used in conjunction with the 
  118.           -BOOT [-NOPROMPT] options and is mutually exclusive of the
  119.           -VER and -HELP options.
  120.  
  121.                                                                    Page 3
  122.  
  123.      -VER (abberviated to -V) displays the version of RunWen you are
  124.           using on the screen.  This option cannot be used in conjunction
  125.           with the -BOOT [-NOPROMPT] options and is mutually exclusive of 
  126.           the -LIST and -HELP options.
  127.  
  128.      -HELP (abbreviated to -H or -?) displays a two-page help screen on
  129.           the use of RunWen.  This option cannot be used in conjunction 
  130.           with the -BOOT [-NOPROMPT] options and is mutually exclusive 
  131.           of the -VER and -LIST options.
  132.  
  133.      REGISTRATION
  134.      ============
  135.  
  136.      Registering your copy of RunWen is simple.  Just print out the 
  137.      ORDERFRM.DOC file, fill in the required information, and send it with
  138.      the requested payment amount.  Your registration will be processed per
  139.      your request and you will be placed on my mailing list for any future
  140.      upgrades.
  141.  
  142.      LICENSE
  143.      =======
  144.  
  145.      You are free to use, copy, and distribute the Shareware version of
  146.      RunWen so long as:
  147.  
  148.      1)  No fee is charged for its use.
  149.  
  150.      2)  If a fee is charged, it must be only to cover the cost of copying
  151.          or distribution.
  152.  
  153.      3)  It must be distributed in its original form with all of the 
  154.          originally released files intact.
  155.  
  156.      4)  It has not been modified in ANY way EXCEPT for compression.
  157.  
  158.      No part of the REGISTERED version of RunWen may be reproduced or
  159.      transmitted in any form or by any means, electronic or otherwise,
  160.      for any purpose other than the purchasers personal use, witout
  161.      the express written permission of the author.
  162.  
  163.  
  164.      WARRANTY
  165.      ========
  166.  
  167.      All warranties are disclaimed, including any damage to hardware and/or
  168.      software, from the use of this product.  In no event will I be held 
  169.      liable to you for any damage including lost profits, lost savings or
  170.      other incidental or consequential damages arising out or your use or
  171.      inability to use this program, or any other claim by any other party.